Skip to content

docs: add CLAUDE.md importing the guidelines#116

Merged
rodrigobnogueira merged 1 commit into
mainfrom
docs/claude-md
Jul 6, 2026
Merged

docs: add CLAUDE.md importing the guidelines#116
rodrigobnogueira merged 1 commit into
mainfrom
docs/claude-md

Conversation

@rodrigobnogueira

@rodrigobnogueira rodrigobnogueira commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

Adds a committed CLAUDE.md that @-imports GUIDELINES_NEST_TRPC.md so the project guidelines are binding for AI coding agents, and restates the two always-on rules:

  • Stryker mutation testing is local-only — never wired into CI.
  • Pre-PR ritual: npm run test:mutation (scope with STRYKER_MUTATE to changed files), reporting surviving mutants in the PR body.

Docs-only. No source, no CI, no .github/ changes.

@rodrigobnogueira @claude
docs: add CLAUDE.md importing the project guidelines
00ff73b 
@-import the repo's GUIDELINES_NEST_*.md so the guidelines are binding for AI
agents, and restate the two always-on rules (Stryker mutation testing — and
full-mode infra where present — are local-only and never in CI; the pre-PR
test:mutation ritual with STRYKER_MUTATE scoping and surviving-mutant reporting).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

📊 Coverage Coverage Report

Metric PR Base Diff
Statements ████████████████████ 664/664 (100%) 664/664 (100%) ⚪ 0%
Branches ████████████████████ 283/283 (100%) 283/283 (100%) ⚪ 0%
Functions ████████████████████ 122/122 (100%) 122/122 (100%) ⚪ 0%
Lines ████████████████████ 639/639 (100%) 639/639 (100%) ⚪ 0%

Updated for 04f2480 | Compared against base branch

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

⏱️ Performance Report
✅ Tests 199 passed, 0 failed, 0 skipped
🧪 Suites 39
⏱️ Total step time 11.00s (install + tests) ⚪ ~0
⚙️ Test execution 3.12s 🟢 -161ms
🐢 Slowest test suites
# Suite Tests Duration vs Base
1 test/generators/schema-generator.spec.ts 19 2.24s 🟢 -117ms
2 test/adapter/trpc-client-adapter-e2e.spec.ts 16 209ms ⚪ ~0
3 test/adapter/trpc-http-adapter.spec.ts 19 90ms ⚪ ~0
4 test/router/trpc-router.spec.ts 29 36ms ⚪ ~0
5 test/context/trpc-context-creator.spec.ts 26 30ms ⚪ ~0
6 test/adapter/trpc-http-adapter-unit.spec.ts 22 18ms ⚪ ~0
7 test/router/trpc-router-lifecycle.spec.ts 11 9ms ⚪ ~0
8 test/generators/zod-serializer.spec.ts 37 7ms ⚪ ~0
9 test/module/trpc-module.spec.ts 4 6ms ⚪ ~0
10 test/decorators/decorators.spec.ts 10 4ms ⚪ ~0
🐌 Slowest individual tests
# Suite Test Duration vs Base
1 schema-generator generateSchemaContent (type-level AppRouter contract) should require a link transformer on typed clients when generated with hasTransformer 1.43s ⚪ ~0
2 schema-generator generateSchemaContent (type-level AppRouter contract) should typecheck generated AppRouter with a typed tRPC client 801ms 🟢 -73ms
3 trpc-client-adapter-e2e real @trpc/client adapter E2E express handles typed queries, mutations, and context extraction 62ms ⚪ ~0
4 trpc-client-adapter-e2e real @trpc/client adapter E2E express runs class-validator DTO validation through ValidationPipe 26ms ⚪ ~0
5 trpc-client-adapter-e2e real @trpc/client adapter E2E express streams subscriptions through the real client 25ms ⚪ ~0
6 trpc-client-adapter-e2e real @trpc/client adapter E2E express reports Zod input errors through the real client 15ms ⚪ ~0
7 trpc-client-adapter-e2e real @trpc/client adapter E2E fastify handles typed queries, mutations, and context extraction 15ms ⚪ ~0
8 trpc-client-adapter-e2e real @trpc/client adapter E2E fastify runs class-validator DTO validation through ValidationPipe 12ms ⚪ ~0
9 trpc-http-adapter TrpcHttpAdapter (server config passthrough) Express should apply responseMeta headers before streaming SSE responses 9ms ⚪ ~0
10 trpc-http-adapter TrpcHttpAdapter Fastify handler should map guard-denied execution to FORBIDDEN/403 8ms ⚪ ~0
11 trpc-http-adapter TrpcHttpAdapter edge cases should handle Fastify GET with createContext 8ms ⚪ ~0
12 trpc-client-adapter-e2e real @trpc/client adapter E2E fastify reports Zod input errors through the real client 7ms ⚪ ~0
13 trpc-client-adapter-e2e real @trpc/client adapter E2E fastify streams subscriptions through the real client 7ms ⚪ ~0
14 trpc-http-adapter TrpcHttpAdapter Express handler should stream subscription responses over GET 7ms ⚪ ~0
15 trpc-client-adapter-e2e real @trpc/client with superjson transformer E2E express round-trips Date instances through queries 6ms ⚪ ~0

Updated for 04f2480 | Compared against base branch

@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

🧠 Cognitive Complexity Report

Metric PR Base Diff
Total complexity 159 159 ⚪ 0
Max function complexity 12 12 ⚪ 0
Functions measured 53 53 ⚪ 0
🧩 Most complex functions
Function Location Complexity Status
serializeZodSchema packages/trpc/generators/zod-serializer.ts:9 12 🟢 OK
generateSchemaContent packages/trpc/generators/schema-generator.ts:58 9 🟢 OK
TrpcContextCreator.extractHttpExceptionMessage packages/trpc/context/trpc-context-creator.ts:467 7 🟢 OK
TrpcHttpAdapter.resolveBody packages/trpc/trpc-http-adapter.ts:124 7 🟢 OK
TrpcRouter.validateSubscriptionOutput packages/trpc/trpc-router.ts:551 7 🟢 OK
(anonymous callback) packages/trpc/context/trpc-context-creator.ts:243 6 🟢 OK
TrpcRouter.assertUniqueAliasPath packages/trpc/trpc-router.ts:436 6 🟢 OK
TrpcRouter.resolveContextId packages/trpc/trpc-router.ts:504 6 🟢 OK
TrpcRouter.createRouterProviderContext packages/trpc/trpc-router.ts:148 5 🟢 OK
(anonymous callback) packages/trpc/trpc-router.ts:320 5 🟢 OK

🧭 Cognitive complexity is reported as a review signal, not a merge gate. Prefer small, intention-revealing refactors when complexity rises.

Updated for 04f2480 | Compared against base branch

@rodrigobnogueira rodrigobnogueira merged commit 7bb51c9 into main Jul 6, 2026
10 checks passed
@rodrigobnogueira rodrigobnogueira deleted the docs/claude-md branch July 6, 2026 05:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@rodrigobnogueira